@serviceme/devtools-core 0.0.3

package/LICENSE.md

@@ -0,0 +1,46 @@
+SERVICEME Core Package — Commercial License
+
+Copyright (c) 2024 Medalsoft Technology Co., Ltd. All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential to Medalsoft Technology Co., Ltd. ("Medalsoft").
+
+GRANT OF LICENSE
+Medalsoft grants authorized users a non-exclusive, non-transferable, limited license
+to use the Software solely for internal business purposes in connection with
+Medalsoft's SERVICEME platform.
+
+RESTRICTIONS
+You may not, and may not permit others to:
+1. Copy, modify, merge, publish, distribute, sublicense, or sell copies of the Software;
+2. Reverse engineer, decompile, disassemble, or attempt to derive the source code;
+3. Remove or alter any proprietary notices, labels, or marks on the Software;
+4. Use the Software for any purpose other than as expressly authorized above;
+5. Transfer, assign, or sublicense your rights under this license to any third party.
+
+INTELLECTUAL PROPERTY
+The Software is protected by copyright laws and international treaties. Medalsoft
+retains all intellectual property rights in and to the Software, including all
+copyright, patent, trade secret, and other proprietary rights.
+
+NO WARRANTY
+THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+LIMITATION OF LIABILITY
+IN NO EVENT SHALL MEDALSOFT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR IN CONNECTION WITH THIS
+LICENSE OR THE USE OF THE SOFTWARE.
+
+TERMINATION
+This license is effective until terminated. It will terminate automatically if you
+fail to comply with any term or condition. Upon termination, you must destroy all
+copies of the Software in your possession.
+
+GOVERNING LAW
+This license shall be governed by and construed in accordance with the laws of
+the People's Republic of China.
+
+CONTACT
+For licensing inquiries, contact: marketing@medalsoft.com

package/README.md

@@ -0,0 +1,15 @@
+# @serviceme/devtools-core
+
+Reusable Node.js core implementation for SERVICEME tooling, including JSON processing, environment checks, project helpers, and OpenCode integration primitives.
+
+## Install
+
+```bash
+npm install @serviceme/devtools-core
+```
+
+## Build
+
+```bash
+pnpm -F @serviceme/devtools-core run build
+```

package/dist/index.d.mts

@@ -0,0 +1,115 @@
+import { EnvironmentCheckResult, KnownEnvironmentTool, ToolCheckResult, ServiceMeImageValidationResult, ServiceMeImageInfo, ServiceMeImageCompressOptions, ServiceMeImageCompressResult, JsonSortOptions, JsonValidationResult, OpenCodeAgentEvent, OpenCodeRuntimeOptions, OpenCodeServerState, AgentSessionStatus, ServiceMeProjectExtractTemplateInput, ServiceMeProjectExtractTemplateResult, ServiceMeProjectInstallDepsResult, ServiceMeProjectMakeScriptsExecutableResult, ServiceMeProjectGitInitResult, ServiceMeProjectScaffoldPruneResult } from '@serviceme/devtools-protocol';
+
+declare class EnvironmentInspector {
+    checkEnvironment(): Promise<EnvironmentCheckResult>;
+    checkTool(toolName: KnownEnvironmentTool): Promise<ToolCheckResult>;
+    private getToolPath;
+    private getToolVersion;
+    private checkNvm;
+    private checkNuget;
+    private getVersionCommand;
+    private parseVersion;
+    private handleToolCheckError;
+}
+
+declare class ImageTools {
+    getSupportedFormats(): string[];
+    validate(filePath: string, sharpModulePath?: string): Promise<ServiceMeImageValidationResult>;
+    getInfo(imagePath: string, sharpModulePath?: string): Promise<ServiceMeImageInfo>;
+    compress(imagePath: string, options: ServiceMeImageCompressOptions): Promise<ServiceMeImageCompressResult>;
+    private compressWithSharp;
+    private getOutputPath;
+    private pathExists;
+    private loadSharp;
+}
+declare function createImageTools(): ImageTools;
+
+interface JsonTools {
+    sort(text: string, options?: Partial<JsonSortOptions>): string;
+    format(text: string, indent?: number): string;
+    validate(text: string): JsonValidationResult;
+    minify(text: string): string;
+}
+declare function createJsonTools(): JsonTools;
+
+interface ServiceMeLogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+declare const noopLogger: ServiceMeLogger;
+declare function createConsoleLogger(prefix?: string): ServiceMeLogger;
+
+interface OpenCodePromptInput {
+    sessionId: string;
+    prompt: string;
+    workspaceRoot?: string;
+    signal?: AbortSignal;
+    onEvent?: (event: OpenCodeAgentEvent) => void;
+}
+interface OpenCodeManagerOptions {
+    command?: string;
+    installUrl?: string;
+    host?: string;
+    portMin?: number;
+    portMax?: number;
+    healthPath?: string;
+    sessionPath?: string;
+    sessionStatusPath?: string;
+    startupPollIntervalMs?: number;
+    idleTimeoutMs?: number;
+    stdoutLogLimitBytes?: number;
+    logger?: ServiceMeLogger;
+}
+declare class OpenCodeManager {
+    private readonly options;
+    private readonly logger;
+    private childProcess;
+    private port;
+    private startupPromise;
+    private idleTimer;
+    private stdoutBytes;
+    constructor(options?: OpenCodeManagerOptions);
+    isAvailable(): Promise<boolean>;
+    isRunning(): boolean;
+    ensureServer(runtime?: OpenCodeRuntimeOptions): Promise<OpenCodeServerState>;
+    getServerState(): Promise<OpenCodeServerState>;
+    createSession(runtime?: OpenCodeRuntimeOptions): Promise<{
+        sessionId: string;
+        title?: string;
+        status: AgentSessionStatus;
+    }>;
+    prompt(input: OpenCodePromptInput): Promise<void>;
+    getSessionStatus(sessionId: string, workspaceRoot?: string): Promise<AgentSessionStatus>;
+    abortSession(sessionId: string, workspaceRoot?: string): Promise<void>;
+    dispose(): Promise<void>;
+    private ensureServerStarted;
+    private startServerProcess;
+    private waitForHealth;
+    private isServerHealthy;
+    private resetIdleTimer;
+    private terminateTrackedProcess;
+    private request;
+    private createQuery;
+    private getLatestAssistantMessage;
+    private mapStatus;
+}
+
+declare class ProjectTools {
+    extractTemplate(zipPath: string, workspacePath: string, tempExtractDir: string, input: ServiceMeProjectExtractTemplateInput): Promise<ServiceMeProjectExtractTemplateResult>;
+    installDependencies(workspacePath: string, command?: string): Promise<ServiceMeProjectInstallDepsResult>;
+    makeScriptsExecutable(workspacePath: string): Promise<ServiceMeProjectMakeScriptsExecutableResult>;
+    initializeGit(workspacePath: string): Promise<ServiceMeProjectGitInitResult>;
+    runScaffoldPrune(workspacePath: string, preset?: string): Promise<ServiceMeProjectScaffoldPruneResult>;
+    private findScripts;
+    private pathExists;
+    private selectExtractedDirectory;
+    private directoryMatchesProjectPattern;
+}
+declare function createProjectTools(): ProjectTools;
+
+declare const unzipFile: (zipPath: string, dest: string) => Promise<void>;
+declare const moveFiles: (sourceDir: string, destDir: string, overwrite?: boolean) => Promise<void>;
+
+export { EnvironmentInspector, ImageTools, type JsonTools, OpenCodeManager, type OpenCodeManagerOptions, type OpenCodePromptInput, ProjectTools, type ServiceMeLogger, createConsoleLogger, createImageTools, createJsonTools, createProjectTools, moveFiles, noopLogger, unzipFile };

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+import { EnvironmentCheckResult, KnownEnvironmentTool, ToolCheckResult, ServiceMeImageValidationResult, ServiceMeImageInfo, ServiceMeImageCompressOptions, ServiceMeImageCompressResult, JsonSortOptions, JsonValidationResult, OpenCodeAgentEvent, OpenCodeRuntimeOptions, OpenCodeServerState, AgentSessionStatus, ServiceMeProjectExtractTemplateInput, ServiceMeProjectExtractTemplateResult, ServiceMeProjectInstallDepsResult, ServiceMeProjectMakeScriptsExecutableResult, ServiceMeProjectGitInitResult, ServiceMeProjectScaffoldPruneResult } from '@serviceme/devtools-protocol';
+
+declare class EnvironmentInspector {
+    checkEnvironment(): Promise<EnvironmentCheckResult>;
+    checkTool(toolName: KnownEnvironmentTool): Promise<ToolCheckResult>;
+    private getToolPath;
+    private getToolVersion;
+    private checkNvm;
+    private checkNuget;
+    private getVersionCommand;
+    private parseVersion;
+    private handleToolCheckError;
+}
+
+declare class ImageTools {
+    getSupportedFormats(): string[];
+    validate(filePath: string, sharpModulePath?: string): Promise<ServiceMeImageValidationResult>;
+    getInfo(imagePath: string, sharpModulePath?: string): Promise<ServiceMeImageInfo>;
+    compress(imagePath: string, options: ServiceMeImageCompressOptions): Promise<ServiceMeImageCompressResult>;
+    private compressWithSharp;
+    private getOutputPath;
+    private pathExists;
+    private loadSharp;
+}
+declare function createImageTools(): ImageTools;
+
+interface JsonTools {
+    sort(text: string, options?: Partial<JsonSortOptions>): string;
+    format(text: string, indent?: number): string;
+    validate(text: string): JsonValidationResult;
+    minify(text: string): string;
+}
+declare function createJsonTools(): JsonTools;
+
+interface ServiceMeLogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+declare const noopLogger: ServiceMeLogger;
+declare function createConsoleLogger(prefix?: string): ServiceMeLogger;
+
+interface OpenCodePromptInput {
+    sessionId: string;
+    prompt: string;
+    workspaceRoot?: string;
+    signal?: AbortSignal;
+    onEvent?: (event: OpenCodeAgentEvent) => void;
+}
+interface OpenCodeManagerOptions {
+    command?: string;
+    installUrl?: string;
+    host?: string;
+    portMin?: number;
+    portMax?: number;
+    healthPath?: string;
+    sessionPath?: string;
+    sessionStatusPath?: string;
+    startupPollIntervalMs?: number;
+    idleTimeoutMs?: number;
+    stdoutLogLimitBytes?: number;
+    logger?: ServiceMeLogger;
+}
+declare class OpenCodeManager {
+    private readonly options;
+    private readonly logger;
+    private childProcess;
+    private port;
+    private startupPromise;
+    private idleTimer;
+    private stdoutBytes;
+    constructor(options?: OpenCodeManagerOptions);
+    isAvailable(): Promise<boolean>;
+    isRunning(): boolean;
+    ensureServer(runtime?: OpenCodeRuntimeOptions): Promise<OpenCodeServerState>;
+    getServerState(): Promise<OpenCodeServerState>;
+    createSession(runtime?: OpenCodeRuntimeOptions): Promise<{
+        sessionId: string;
+        title?: string;
+        status: AgentSessionStatus;
+    }>;
+    prompt(input: OpenCodePromptInput): Promise<void>;
+    getSessionStatus(sessionId: string, workspaceRoot?: string): Promise<AgentSessionStatus>;
+    abortSession(sessionId: string, workspaceRoot?: string): Promise<void>;
+    dispose(): Promise<void>;
+    private ensureServerStarted;
+    private startServerProcess;
+    private waitForHealth;
+    private isServerHealthy;
+    private resetIdleTimer;
+    private terminateTrackedProcess;
+    private request;
+    private createQuery;
+    private getLatestAssistantMessage;
+    private mapStatus;
+}
+
+declare class ProjectTools {
+    extractTemplate(zipPath: string, workspacePath: string, tempExtractDir: string, input: ServiceMeProjectExtractTemplateInput): Promise<ServiceMeProjectExtractTemplateResult>;
+    installDependencies(workspacePath: string, command?: string): Promise<ServiceMeProjectInstallDepsResult>;
+    makeScriptsExecutable(workspacePath: string): Promise<ServiceMeProjectMakeScriptsExecutableResult>;
+    initializeGit(workspacePath: string): Promise<ServiceMeProjectGitInitResult>;
+    runScaffoldPrune(workspacePath: string, preset?: string): Promise<ServiceMeProjectScaffoldPruneResult>;
+    private findScripts;
+    private pathExists;
+    private selectExtractedDirectory;
+    private directoryMatchesProjectPattern;
+}
+declare function createProjectTools(): ProjectTools;
+
+declare const unzipFile: (zipPath: string, dest: string) => Promise<void>;
+declare const moveFiles: (sourceDir: string, destDir: string, overwrite?: boolean) => Promise<void>;
+
+export { EnvironmentInspector, ImageTools, type JsonTools, OpenCodeManager, type OpenCodeManagerOptions, type OpenCodePromptInput, ProjectTools, type ServiceMeLogger, createConsoleLogger, createImageTools, createJsonTools, createProjectTools, moveFiles, noopLogger, unzipFile };