@kwonye/mcpx 0.1.105 → 0.1.107

package/dist/core/secrets.d.ts

@@ -1,9 +1,19 @@
+import type { SecretBackendKind } from "../types.js";
+export interface SecretBackendSwitchResult {
+    backend: SecretBackendKind;
+    changed: boolean;
+    migrated: string[];
+    preserved: string[];
+    removedFrom: SecretBackendKind | null;
+}
+export declare function describeSecretBackend(backend: SecretBackendKind): string;
+export declare function getSecretBackend(configPath?: string): SecretBackendKind;
+export declare function switchSecretBackend(target: SecretBackendKind, configPath?: string): SecretBackendSwitchResult;
 export declare class SecretsManager {
     private readonly storePath;
     private readonly keyPath;
     constructor(storePath?: string, keyPath?: string);
-    private readStore;
-    private recoverCorruptStore;
+    get backend(): SecretBackendKind;
     listSecretNames(): string[];
     setSecret(name: string, value: string): void;
     removeSecret(name: string): void;

package/dist/core/served-skills.d.ts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import type { McpxConfig } from "../types.js";
+export declare function skillVisible(config: McpxConfig, id: string, projectPath?: string): boolean;
+declare const frontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+}, z.core.$loose>;
+interface ServedSkill {
+    uri: string;
+    frontmatter: z.infer<typeof frontmatterSchema>;
+    resources: Array<{
+        uri: string;
+        digest: string;
+        size: number;
+    }>;
+    files: Map<string, Buffer>;
+}
+export declare function servedSkills(config: McpxConfig, projectPath?: string): ServedSkill[];
+export declare function listServedSkills(config: McpxConfig, projectPath?: string, cursor?: string): {
+    ttlMs: number;
+    cacheScope: string;
+    nextCursor?: string | undefined;
+    resultType: string;
+    skills: {
+        uri: string;
+        frontmatter: z.infer<typeof frontmatterSchema>;
+        resources: Array<{
+            uri: string;
+            digest: string;
+            size: number;
+        }>;
+    }[];
+};
+export declare function getServedSkill(config: McpxConfig, uri: string, projectPath?: string): {
+    resultType: string;
+    skill: {
+        uri: string;
+        frontmatter: z.infer<typeof frontmatterSchema>;
+        resources: Array<{
+            uri: string;
+            digest: string;
+            size: number;
+        }>;
+    };
+    ttlMs: number;
+    cacheScope: string;
+};
+export declare function readServedSkill(config: McpxConfig, uri: string, projectPath?: string): {
+    contents: ({
+        text: string;
+        uri: string;
+        mimeType: string;
+    } | {
+        blob: string;
+        uri: string;
+        mimeType: string;
+    })[];
+    ttlMs: number;
+    cacheScope: string;
+};
+export {};
+//# sourceMappingURL=served-skills.d.ts.map

package/dist/core/status.d.ts

@@ -32,6 +32,7 @@ export interface StatusReport {
     servers: StatusServerEntry[];
     clients: McpxConfig["clients"];
     projects?: McpxConfig["projects"];
+    fetchError?: string;
     totalGlobalTokens?: number;
     totalProjectTokens?: Record<string, number>;
 }

package/dist/core/sync-plan.d.ts

@@ -0,0 +1,14 @@
+/** Read-only synchronization preview; credentials and raw configurations stay local. */
+export declare function planSynchronization(targets?: string[]): {
+    revision: number;
+    harnesses: {
+        id: string;
+        configPath: string | null;
+        changes: {
+            name: string;
+            action: string;
+        }[];
+        message: string;
+    }[];
+};
+//# sourceMappingURL=sync-plan.d.ts.map

package/dist/core/sync.d.ts

@@ -3,7 +3,10 @@ import { SecretsManager } from "./secrets.js";
 export interface SyncOptions {
     targetClients?: ClientId[];
     importScan?: boolean;
+    configPath?: string;
 }
+/** Canonical sync transaction shared by the CLI, desktop service and plugins. */
+export declare function synchronizeClients(options?: SyncOptions, secrets?: SecretsManager): Promise<SyncSummary>;
 export interface SyncSummary {
     gatewayUrl: string;
     imports: SyncImportReport;

package/dist/core/telemetry.d.ts

@@ -17,9 +17,10 @@ declare const launchModeSchema: z.ZodEnum<{
     status: "status";
     clients: "clients";
     project: "project";
-    skill: "skill";
     proxy: "proxy";
     auth: "auth";
+    skill: "skill";
+    list: "list";
     plugin: "plugin";
     desktop: "desktop";
     daemon: "daemon";
@@ -27,7 +28,6 @@ declare const launchModeSchema: z.ZodEnum<{
     remove: "remove";
     enable: "enable";
     disable: "disable";
-    list: "list";
     sync: "sync";
     doctor: "doctor";
     secret: "secret";

package/dist/core/tui.d.ts

@@ -0,0 +1,20 @@
+type TuiRow = {
+    title: string;
+    state: string;
+    detail: string;
+};
+interface TuiFrameOptions {
+    width: number;
+    height: number;
+    revision: number;
+    view: number;
+    summary: string;
+    rows: TuiRow[];
+    selection: number;
+    details: string[];
+    status: string;
+}
+export declare function renderManagementTuiFrame(frame: TuiFrameOptions): string;
+export declare function runManagementTui(cliPath: string): Promise<void>;
+export {};
+//# sourceMappingURL=tui.d.ts.map

package/dist/core/verify-upstreams.d.ts

@@ -0,0 +1,4 @@
+import type { McpxConfig } from "../types.js";
+/** Only discovery/list operations are used before retiring native registrations. */
+export declare function verifyUpstreams(config: McpxConfig, names: string[]): Promise<void>;
+//# sourceMappingURL=verify-upstreams.d.ts.map

package/dist/core/work-limiter.d.ts

@@ -0,0 +1,10 @@
+/** Bounds work per upstream instance, including queued requests. */
+export declare class WorkLimiter {
+    private readonly concurrency;
+    private readonly queueLimit;
+    private active;
+    private waiting;
+    constructor(concurrency?: number, queueLimit?: number);
+    run<T>(signal: AbortSignal, work: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=work-limiter.d.ts.map

package/dist/gateway/server.d.ts

@@ -1,4 +1,5 @@
 import http from "node:http";
+import { WorkLimiter } from "../core/work-limiter.js";
 import { Client } from "@modelcontextprotocol/client";
 import { StdioClientTransport } from "@modelcontextprotocol/client/stdio";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
@@ -10,6 +11,7 @@ interface GatewayServerOptions {
     secrets: SecretsManager;
 }
 interface UpstreamConnection {
+    limiter: WorkLimiter;
     fingerprint: string;
     client: Client;
     transport: StdioClientTransport | StreamableHTTPClientTransport;

package/dist/types.d.ts

@@ -1,12 +1,15 @@
-export type ClientId = "claude" | "claude-desktop" | "codex" | "cursor" | "cline" | "opencode" | "kiro" | "vscode" | "qwen" | "openclaw" | "hermes";
+/** Harness IDs come from the adapter registry, including project installations. */
+export type ClientId = string;
 export type PluginComponent = "mcpServers" | "skills" | "hooks" | "agents" | "commands";
 export interface HttpServerSpec {
+    scope?: string;
     transport: "http";
     url: string;
     headers?: Record<string, string>;
     enabled?: boolean;
 }
 export interface StdioServerSpec {
+    scope?: string;
     transport: "stdio";
     command: string;
     args?: string[];
@@ -20,6 +23,8 @@ export interface GatewayConfig {
     tokenRef: string;
     autoStart: boolean;
 }
+/** Where stored secrets live. `file` is the default encrypted file; `keychain` is opt-in. */
+export type SecretBackendKind = "file" | "keychain";
 export type ClientStatus = "SYNCED" | "UNSUPPORTED_HTTP" | "ERROR" | "SKIPPED";
 export interface ClientSyncState {
     status: ClientStatus;
@@ -38,6 +43,44 @@ export interface ProjectScope {
 }
 export interface McpxConfig {
     schemaVersion: 1;
+    consumers?: Record<string, {
+        tokenRef: string;
+        projectPath?: string;
+    }>;
+    packages?: Record<string, {
+        id: string;
+        root: string;
+        source: string;
+        harness: string;
+        fingerprint: string;
+        pinned: boolean;
+        name?: string;
+        identity?: string;
+        servers?: string[];
+        skills?: Array<{
+            id: string;
+            path: string;
+            projectionPath: string;
+        }>;
+        scope?: string;
+        previous?: {
+            root: string;
+            fingerprint: string;
+        };
+    }>;
+    revision?: number;
+    harnesses?: Record<string, {
+        mode: "observe" | "selected" | "automatic";
+    }>;
+    origins?: Record<string, {
+        id: string;
+        kind: string;
+        harness: string;
+        source: string;
+        nativeKey: string;
+        fingerprint: string;
+        operationId: string;
+    }>;
     name?: string;
     gateway: GatewayConfig;
     servers: Record<string, UpstreamServerSpec>;
@@ -45,6 +88,9 @@ export interface McpxConfig {
     projects?: Record<string, ProjectConfig>;
     plugins?: Record<string, ManagedPlugin>;
     marketplaces?: Record<string, ManagedMarketplace>;
+    secrets?: {
+        backend: SecretBackendKind;
+    };
 }
 export interface ManagedEntry {
     fingerprint: string;
@@ -117,6 +163,9 @@ export interface SyncResult {
     driftedEntries?: string[];
 }
 export interface Skill {
+    projectionPath?: string;
+    scope?: string;
+    ownerHarness?: string;
     id: string;
     content: string;
     /** Canonical directory containing SKILL.md and optional resources. */
@@ -144,12 +193,24 @@ export interface PluginSyncResult {
     unsupported: PluginComponent[];
     error?: string;
 }
+export interface HarnessDescriptor {
+    label?: string;
+    projectConfig?: string;
+    skillPath?: string;
+    projectSkills?: string;
+    skillLayout?: "dir" | "flat";
+    pluginComponents?: PluginComponent[];
+}
 export interface ClientAdapter {
+    descriptor?: HarnessDescriptor;
+    managedName?(serverName: string): string;
     id: ClientId;
     detectConfigPath(): string | null;
     supportsHttp(): boolean;
     scanForImports(config: McpxConfig, managedIndex: ManagedIndex): ClientImportScanResult;
     syncGateway(config: McpxConfig, options: SyncClientOptions): SyncResult;
+    skillDirectory?(): string;
+    additionalSkillDirectories?(): string[];
     syncSkills?(skills: Skill[]): void;
     syncPlugins?(plugins: PluginSyncInput[]): PluginSyncResult;
 }

package/dist/util/fs.d.ts

@@ -2,4 +2,6 @@ export declare function readJsonFile<T>(filePath: string, fallback: T): T;
 export declare function writeJsonAtomic(filePath: string, data: unknown): void;
 export declare function sha256(value: string): string;
 export declare function safeReadFile(filePath: string): string | null;
+/** Native configuration must fail closed; malformed files are never reset. */
+export declare function readJsonStrict<T>(filePath: string, fallback: T): T;
 //# sourceMappingURL=fs.d.ts.map

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const APP_VERSION = "0.1.3";
+export declare const APP_VERSION = "0.1.107";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kwonye/mcpx",
-  "version": "0.1.105",
+  "version": "0.1.107",
   "description": "HTTP-first MCP gateway and cross-client installer",
   "keywords": [
     "mcp",

package/dist/adapters/opencode.d.ts

@@ -1,11 +0,0 @@
-import type { ClientAdapter, ManagedIndex, McpxConfig, Skill, SyncClientOptions, SyncResult, PluginSyncInput, PluginSyncResult } from "../types.js";
-export declare class OpenCodeAdapter implements ClientAdapter {
-    readonly id: "opencode";
-    detectConfigPath(): string | null;
-    supportsHttp(): boolean;
-    syncPlugins(plugins: PluginSyncInput[]): PluginSyncResult;
-    syncSkills(skills: Skill[]): void;
-    scanForImports(_config: McpxConfig, managedIndex: ManagedIndex): import("../types.js").ClientImportScanResult;
-    syncGateway(_config: McpxConfig, options: SyncClientOptions): SyncResult;
-}
-//# sourceMappingURL=opencode.d.ts.map