@nekzus/liop-studio 1.0.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,173 @@
+import { T as TargetConnectionConfig, S as ScanReport, a as ScannedTargetNode, E as EnrichedTool, b as StudioTransport, c as TargetTransportType, d as ExecutionResult } from './index-DLA-Sm4s.js';
+export { e as ExecutionTelemetry, f as ServerOptions, g as createStudioServer } from './index-DLA-Sm4s.js';
+import '@hono/node-server';
+import 'hono/types';
+import 'hono';
+
+/**
+ * Autodetects target connection type from raw target string or arguments array
+ */
+declare function resolveTargetConfig(target: string | string[], options?: {
+    token?: string;
+    grpc?: boolean;
+    mesh?: boolean;
+} | string): TargetConnectionConfig;
+declare function runScan(targetStr: string, options: {
+    token?: string;
+    json?: boolean;
+}): Promise<void>;
+
+declare function formatScanTable(report: ScanReport): string;
+
+declare class NetworkDiscoveryEngine {
+    private static instance;
+    private customTargets;
+    static getInstance(): NetworkDiscoveryEngine;
+    /**
+     * Register or update a custom target dynamically in the mesh topology.
+     */
+    registerCustomTarget(node: ScannedTargetNode): void;
+    /**
+     * Retrieve all dynamically registered custom target nodes.
+     */
+    getCustomTargets(): ScannedTargetNode[];
+    /**
+     * Clear registered custom targets.
+     */
+    clearCustomTargets(): void;
+    /**
+     * Probe a specific HTTP/Health endpoint dynamically.
+     */
+    probeHttpNode(host: string, port: number, timeoutMs?: number): Promise<{
+        name?: string;
+        version?: string;
+        tier?: 1 | 2 | 3;
+        peerId?: string;
+        multiaddrs?: string[];
+        tools?: string[];
+        enrichedTools?: EnrichedTool[];
+        rttMs: number;
+    } | null>;
+    /**
+     * Dynamically discover all active servers across the target host network.
+     */
+    scanNetwork(host?: string): Promise<ScannedTargetNode[]>;
+    /**
+     * Find the associated HTTP probe info for a given gRPC target address.
+     */
+    resolveNodeForGrpcTarget(targetAddress: string, latencyMs: number, status: "online" | "offline" | "degraded"): Promise<{
+        node: ScannedTargetNode;
+        tools: EnrichedTool[];
+    }>;
+}
+
+/**
+ * Validates and sanitizes a subprocess executable name (CWE-78 defense).
+ * Strictly forbids shell metacharacters and ensures shell: false execution.
+ */
+declare function sanitizeCommand(command: string, args?: string[]): string;
+/**
+ * Validates an HTTP target URL against SSRF and cloud metadata exfiltration (CWE-918).
+ */
+declare function validateHttpTarget(targetUrl: string): URL;
+declare const sanitizeUrl: typeof validateHttpTarget;
+/**
+ * Validates Host headers to prevent DNS Rebinding attacks on local ports.
+ */
+declare function validateHostHeader(host: string | undefined, allowedHosts?: string[]): boolean;
+
+interface GrpcTransportOptions {
+    target: string;
+    useTls?: boolean;
+    token?: string;
+}
+declare class GrpcTransport implements StudioTransport {
+    readonly type: TargetTransportType;
+    private client;
+    private connected;
+    private target;
+    private token?;
+    constructor(options: GrpcTransportOptions);
+    isConnected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    scan(): Promise<ScanReport>;
+    listTools(): Promise<EnrichedTool[]>;
+    callTool(name: string, args: Record<string, unknown>, envelope?: string, onStep?: (phase: string, detail: string, status: "pending" | "running" | "success" | "failed", durationMs?: number) => Promise<void>): Promise<ExecutionResult>;
+}
+
+interface HttpTransportOptions {
+    url: string;
+    authToken?: string;
+    token?: string;
+}
+declare class HttpTransport implements StudioTransport {
+    readonly type: TargetTransportType;
+    private connected;
+    private targetUrl;
+    private authToken?;
+    private serverInfo?;
+    private cachedTools;
+    constructor(options: HttpTransportOptions);
+    isConnected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    scan(): Promise<ScanReport>;
+    listTools(): Promise<EnrichedTool[]>;
+    callTool(name: string, args: Record<string, unknown>, envelope?: string, onStep?: (phase: string, detail: string, status: "pending" | "running" | "success" | "failed", durationMs?: number) => Promise<void>): Promise<ExecutionResult>;
+    private postJsonRpc;
+}
+
+interface MeshTransportOptions {
+    bootstrapNodes?: string[];
+    swarmKey?: string | Uint8Array;
+    nexusUrl?: string;
+    clientId?: string;
+    clientSecret?: string;
+}
+declare class MeshTransport implements StudioTransport {
+    readonly type: TargetTransportType;
+    private client;
+    private connected;
+    private options;
+    private cachedTools;
+    constructor(options?: MeshTransportOptions);
+    isConnected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    scan(): Promise<ScanReport>;
+    listTools(): Promise<EnrichedTool[]>;
+    callTool(name: string, args: Record<string, unknown>, envelope?: string, onStep?: (phase: string, detail: string, status: "pending" | "running" | "success" | "failed", durationMs?: number) => Promise<void>): Promise<ExecutionResult>;
+}
+
+interface StdioTransportOptions {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+}
+declare class StdioTransport implements StudioTransport {
+    private options;
+    readonly type: TargetTransportType;
+    private child;
+    private connected;
+    private pendingRequests;
+    private nextRequestId;
+    private stdoutBuffer;
+    private serverInfo?;
+    private cachedTools;
+    constructor(options: StdioTransportOptions);
+    isConnected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    scan(): Promise<ScanReport>;
+    listTools(): Promise<EnrichedTool[]>;
+    callTool(name: string, args: Record<string, unknown>, envelope?: string, onStep?: (phase: string, detail: string, status: "pending" | "running" | "success" | "failed", durationMs?: number) => Promise<void>): Promise<ExecutionResult>;
+    private handleStdoutChunk;
+    private sendJsonRpcRequest;
+    private sendJsonRpcNotification;
+}
+
+declare function createTransport(config: TargetConnectionConfig): StudioTransport;
+
+export { EnrichedTool, ExecutionResult, GrpcTransport, type GrpcTransportOptions, HttpTransport, type HttpTransportOptions, MeshTransport, type MeshTransportOptions, NetworkDiscoveryEngine, ScanReport, ScannedTargetNode, StdioTransport, type StdioTransportOptions, StudioTransport, TargetConnectionConfig, TargetTransportType, createTransport, formatScanTable, resolveTargetConfig, runScan, sanitizeCommand, sanitizeUrl, validateHostHeader, validateHttpTarget };