cdeops 13.4.1-alpha.48 → 13.4.1

package/client.d.ts

@@ -636,4 +636,182 @@ declare module 'cdeops/client' {
             export function getNodeById(nodeId: string): Promise<IAINodeContribution | undefined>;
         }
     }
+
+    // ── Gateway SPI ──
+
+    /** Configuration returned by a gateway provider. */
+    export interface IGatewayConfig {
+        config?: Record<string, unknown> | null;
+        hash: string;
+    }
+
+    /** Health/status of a gateway. */
+    export interface IGatewayStatus {
+        healthy: boolean;
+        version?: string;
+        uptime?: number;
+    }
+
+    /** Status of a messaging channel on the gateway. */
+    export interface IGatewayChannelStatus {
+        channel: string;
+        configured: boolean;
+        connected: boolean;
+        enabled: boolean;
+        accountId?: string;
+        error?: string;
+    }
+
+    /** A provisioned gateway instance. */
+    export interface IGatewayInstance {
+        releaseName: string;
+        slug: string;
+        url: string;
+        status: string;
+        userId: string;
+        projectId?: string;
+        namespace?: string;
+        replicas: number;
+        readyReplicas: number;
+        imageVariant?: string;
+    }
+
+    /** Resource usage metrics for a gateway instance. */
+    export interface IGatewayResourceUsage {
+        cpuRequest?: string;
+        cpuLimit?: string;
+        cpuActual?: string;
+        memoryRequest?: string;
+        memoryLimit?: string;
+        memoryActual?: string;
+        storageCapacity?: string;
+    }
+
+    /** Session URL for browser access to a gateway instance. */
+    export interface IGatewaySessionUrl {
+        sessionUrl: string;
+        expiresAt: number;
+    }
+
+    /** WebSocket chat connection details. */
+    export interface IGatewayChatConnection {
+        url: string;
+        wsUrl: string;
+        token: string;
+        proxyToken: string;
+        expiresAt?: number;
+    }
+
+    /** Input for provisioning a new gateway instance. */
+    export interface IProvisionGatewayInput {
+        userId: string;
+        userName?: string;
+        email?: string;
+        imageVariant?: string;
+        tier?: string;
+        workspaceEnabled?: boolean;
+        workspaceSize?: string;
+        persistenceEnabled?: boolean;
+    }
+
+    /** Agent detail from the gateway. */
+    export interface IGatewayAgentDetail {
+        id: string;
+        name?: string;
+        isDefault: boolean;
+        workspace?: string;
+        heartbeat?: { enabled: boolean; every?: string };
+        sessions?: { count: number };
+        files?: Array<{ name: string; path: string; missing: boolean; size?: number }>;
+    }
+
+    /**
+     * Service interface for interacting with a gateway's configuration and agents.
+     * Extensions implement this to provide gateway functionality.
+     */
+    export interface IGatewayService {
+        getConfig(projectId: string, userId: string): Promise<IGatewayConfig>;
+        updateConfig(projectId: string, userId: string, patch: Record<string, unknown>): Promise<void>;
+        replaceConfig(projectId: string, userId: string, config: Record<string, unknown>): Promise<void>;
+        getStatus(projectId: string, userId: string): Promise<IGatewayStatus>;
+        getModels(projectId: string, userId: string): Promise<unknown[]>;
+        getUsage(projectId: string, userId: string): Promise<unknown>;
+        listAgents(projectId: string, userId: string): Promise<unknown[]>;
+        getAgentDetail(projectId: string, userId: string, agentId: string): Promise<IGatewayAgentDetail>;
+        createAgent(
+            projectId: string,
+            userId: string,
+            name: string,
+            workspace?: string,
+        ): Promise<{ ok: boolean; agentId: string }>;
+        updateAgent(
+            projectId: string,
+            userId: string,
+            agentId: string,
+            params: { name?: string; model?: string },
+        ): Promise<{ ok: boolean; agentId: string }>;
+        deleteAgent(projectId: string, userId: string, agentId: string): Promise<{ ok: boolean; agentId: string }>;
+        listSessions(projectId: string, userId: string): Promise<unknown>;
+        setAgentFile(projectId: string, userId: string, agentId: string, name: string, content: string): Promise<void>;
+    }
+
+    /** Service interface for managing messaging channels on a gateway. */
+    export interface IGatewayChannelService {
+        connectChannel(
+            projectId: string,
+            userId: string,
+            channel: string,
+            credentials: Record<string, unknown>,
+        ): Promise<void>;
+        disconnectChannel(projectId: string, userId: string, channel: string, accountId?: string): Promise<void>;
+        getChannelsStatus(projectId: string, userId: string, probe?: boolean): Promise<IGatewayChannelStatus[]>;
+    }
+
+    /** Service interface for managing gateway instance lifecycle. */
+    export interface IGatewayInstanceService {
+        provisionInstance(projectId: string, req: IProvisionGatewayInput): Promise<IGatewayInstance>;
+        stopInstance(projectId: string, userId: string): Promise<IGatewayInstance>;
+        startInstance(projectId: string, userId: string): Promise<IGatewayInstance>;
+        deleteInstance(projectId: string, userId: string, deletePVCs?: boolean): Promise<void>;
+        getInstanceStatus(projectId: string, userId: string): Promise<IGatewayInstance>;
+        listInstances(projectId: string): Promise<IGatewayInstance[]>;
+        getResourceUsage(projectId: string, userId: string): Promise<IGatewayResourceUsage>;
+        generateSessionUrl(
+            projectId: string,
+            userId: string,
+            agentId?: string,
+            workspaceId?: number,
+        ): Promise<IGatewaySessionUrl>;
+        getChatConnection(projectId: string, userId: string): Promise<IGatewayChatConnection>;
+    }
+
+    /** A registered gateway provider returned by an extension. */
+    export interface IGatewayProvider {
+        /** Unique identifier for this gateway type (e.g. 'openclaw', 'custom'). */
+        id: string;
+        /** Human-readable display name. */
+        displayName: string;
+        /** Gateway config/agent/model service. */
+        gatewayService: IGatewayService;
+        /** Channel management service. */
+        channelService: IGatewayChannelService;
+        /** Instance lifecycle service. */
+        instanceService: IGatewayInstanceService;
+    }
+
+    /**
+     * Namespace for gateway provider registration.
+     * Extensions call `registerProvider` during activation;
+     * the host queries registered providers at runtime.
+     */
+    export namespace gateway {
+        /** Register a gateway provider. Returns a disposable to unregister. */
+        export function registerProvider(provider: IGatewayProvider): Disposable;
+
+        /** Get a registered gateway provider by id. */
+        export function getProvider(id: string): IGatewayProvider | undefined;
+
+        /** Get all registered gateway providers. */
+        export function getProviders(): IGatewayProvider[];
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cdeops",
-    "version": "13.4.1-alpha.48",
+    "version": "13.4.1",
     "description": "Cdecode - Extension API: build extensions that enhance coding experience in your cdeops editor",
     "license": "Apache-2.0",
     "author": "adminide-stack-user",
@@ -52,9 +52,6 @@
         "build:lib": "",
         "build:lib:watch": "npm run build:lib -- --watch",
         "docs": "typedoc",
-        "prepublishOnly": "npm run tslint && npm run docs",
-        "tslint": "tslint -c tslint.json -p tsconfig.json './src/**/*.{ts,js}'",
         "watch": "npm run build:lib:watch"
-    },
-    "gitHead": "626ea1c0f93abb3dcbccd92c9c1691f7d346d79f"
+    }
 }

package/server.d.ts

@@ -635,4 +635,182 @@ declare module 'cdeops/server' {
             export function getNodeById(nodeId: string): Promise<IAINodeContribution | undefined>;
         }
     }
+
+    // ── Gateway SPI ──
+
+    /** Configuration returned by a gateway provider. */
+    export interface IGatewayConfig {
+        config?: Record<string, unknown> | null;
+        hash: string;
+    }
+
+    /** Health/status of a gateway. */
+    export interface IGatewayStatus {
+        healthy: boolean;
+        version?: string;
+        uptime?: number;
+    }
+
+    /** Status of a messaging channel on the gateway. */
+    export interface IGatewayChannelStatus {
+        channel: string;
+        configured: boolean;
+        connected: boolean;
+        enabled: boolean;
+        accountId?: string;
+        error?: string;
+    }
+
+    /** A provisioned gateway instance. */
+    export interface IGatewayInstance {
+        releaseName: string;
+        slug: string;
+        url: string;
+        status: string;
+        userId: string;
+        projectId?: string;
+        namespace?: string;
+        replicas: number;
+        readyReplicas: number;
+        imageVariant?: string;
+    }
+
+    /** Resource usage metrics for a gateway instance. */
+    export interface IGatewayResourceUsage {
+        cpuRequest?: string;
+        cpuLimit?: string;
+        cpuActual?: string;
+        memoryRequest?: string;
+        memoryLimit?: string;
+        memoryActual?: string;
+        storageCapacity?: string;
+    }
+
+    /** Session URL for browser access to a gateway instance. */
+    export interface IGatewaySessionUrl {
+        sessionUrl: string;
+        expiresAt: number;
+    }
+
+    /** WebSocket chat connection details. */
+    export interface IGatewayChatConnection {
+        url: string;
+        wsUrl: string;
+        token: string;
+        proxyToken: string;
+        expiresAt?: number;
+    }
+
+    /** Input for provisioning a new gateway instance. */
+    export interface IProvisionGatewayInput {
+        userId: string;
+        userName?: string;
+        email?: string;
+        imageVariant?: string;
+        tier?: string;
+        workspaceEnabled?: boolean;
+        workspaceSize?: string;
+        persistenceEnabled?: boolean;
+    }
+
+    /** Agent detail from the gateway. */
+    export interface IGatewayAgentDetail {
+        id: string;
+        name?: string;
+        isDefault: boolean;
+        workspace?: string;
+        heartbeat?: { enabled: boolean; every?: string };
+        sessions?: { count: number };
+        files?: Array<{ name: string; path: string; missing: boolean; size?: number }>;
+    }
+
+    /**
+     * Service interface for interacting with a gateway's configuration and agents.
+     * Extensions implement this to provide gateway functionality.
+     */
+    export interface IGatewayService {
+        getConfig(projectId: string, userId: string): Promise<IGatewayConfig>;
+        updateConfig(projectId: string, userId: string, patch: Record<string, unknown>): Promise<void>;
+        replaceConfig(projectId: string, userId: string, config: Record<string, unknown>): Promise<void>;
+        getStatus(projectId: string, userId: string): Promise<IGatewayStatus>;
+        getModels(projectId: string, userId: string): Promise<unknown[]>;
+        getUsage(projectId: string, userId: string): Promise<unknown>;
+        listAgents(projectId: string, userId: string): Promise<unknown[]>;
+        getAgentDetail(projectId: string, userId: string, agentId: string): Promise<IGatewayAgentDetail>;
+        createAgent(
+            projectId: string,
+            userId: string,
+            name: string,
+            workspace?: string,
+        ): Promise<{ ok: boolean; agentId: string }>;
+        updateAgent(
+            projectId: string,
+            userId: string,
+            agentId: string,
+            params: { name?: string; model?: string },
+        ): Promise<{ ok: boolean; agentId: string }>;
+        deleteAgent(projectId: string, userId: string, agentId: string): Promise<{ ok: boolean; agentId: string }>;
+        listSessions(projectId: string, userId: string): Promise<unknown>;
+        setAgentFile(projectId: string, userId: string, agentId: string, name: string, content: string): Promise<void>;
+    }
+
+    /** Service interface for managing messaging channels on a gateway. */
+    export interface IGatewayChannelService {
+        connectChannel(
+            projectId: string,
+            userId: string,
+            channel: string,
+            credentials: Record<string, unknown>,
+        ): Promise<void>;
+        disconnectChannel(projectId: string, userId: string, channel: string, accountId?: string): Promise<void>;
+        getChannelsStatus(projectId: string, userId: string, probe?: boolean): Promise<IGatewayChannelStatus[]>;
+    }
+
+    /** Service interface for managing gateway instance lifecycle. */
+    export interface IGatewayInstanceService {
+        provisionInstance(projectId: string, req: IProvisionGatewayInput): Promise<IGatewayInstance>;
+        stopInstance(projectId: string, userId: string): Promise<IGatewayInstance>;
+        startInstance(projectId: string, userId: string): Promise<IGatewayInstance>;
+        deleteInstance(projectId: string, userId: string, deletePVCs?: boolean): Promise<void>;
+        getInstanceStatus(projectId: string, userId: string): Promise<IGatewayInstance>;
+        listInstances(projectId: string): Promise<IGatewayInstance[]>;
+        getResourceUsage(projectId: string, userId: string): Promise<IGatewayResourceUsage>;
+        generateSessionUrl(
+            projectId: string,
+            userId: string,
+            agentId?: string,
+            workspaceId?: number,
+        ): Promise<IGatewaySessionUrl>;
+        getChatConnection(projectId: string, userId: string): Promise<IGatewayChatConnection>;
+    }
+
+    /** A registered gateway provider returned by an extension. */
+    export interface IGatewayProvider {
+        /** Unique identifier for this gateway type (e.g. 'openclaw', 'custom'). */
+        id: string;
+        /** Human-readable display name. */
+        displayName: string;
+        /** Gateway config/agent/model service. */
+        gatewayService: IGatewayService;
+        /** Channel management service. */
+        channelService: IGatewayChannelService;
+        /** Instance lifecycle service. */
+        instanceService: IGatewayInstanceService;
+    }
+
+    /**
+     * Namespace for gateway provider registration.
+     * Extensions call `registerProvider` during activation;
+     * the host queries registered providers at runtime.
+     */
+    export namespace gateway {
+        /** Register a gateway provider. Returns a disposable to unregister. */
+        export function registerProvider(provider: IGatewayProvider): Disposable;
+
+        /** Get a registered gateway provider by id. */
+        export function getProvider(id: string): IGatewayProvider | undefined;
+
+        /** Get all registered gateway providers. */
+        export function getProviders(): IGatewayProvider[];
+    }
 }

package/server.js

@@ -2,8 +2,54 @@
 // `require('cdeops/server')`. It delegates to the extension host's runtime implementation of this module by calling
 // `global.require` (which ensures that the extension host's `require` is called at runtime).
 //
+// When running outside an extension host (e.g., standalone CLI execution), this module provides a
+// lightweight fallback that captures registerCommand handlers so they can be invoked directly.
+//
 // This dummy file is used when extension is bundled with a JavaScript bundler that lacks support for externals
 // (or when `cdeops/server` is not configured as an external module). Parcel does not support extenals
 // (https://github.com/parcel-bundler/parcel/issues/144). Webpack, Rollup, and Microbundle support externals.
 
-module.exports = require('cdeops/server')
+// Try the extension host first; fall back to a standalone shim for CLI use.
+let hostModule;
+try {
+    // In the extension host, global.require('cdeops/server') returns the real API.
+    // Outside the host this will either throw or return this same module (circular), so we detect both.
+    const candidate = global.require('cdeops/server');
+    if (candidate && candidate !== module.exports && candidate !== exports && typeof candidate.commands === 'object') {
+        hostModule = candidate;
+    }
+} catch (_) {
+    // No extension host — use standalone fallback below.
+}
+
+if (hostModule) {
+    module.exports = hostModule;
+} else {
+    // ── Standalone fallback ─────────────────────────────────────────────────────
+    // Provides just enough of the cdeops/server API for extensions to activate
+    // and register command handlers when executed by the CLI outside the IDE.
+    const _handlers = Object.create(null);
+
+    const commands = {
+        _handlers,
+        registerCommand(id, handler) {
+            _handlers[id] = handler;
+            return {
+                dispose() {
+                    delete _handlers[id];
+                },
+            };
+        },
+        executeCommand(id) {
+            const args = Array.prototype.slice.call(arguments, 1);
+            const h = _handlers[id];
+            if (!h) throw new Error('Command not found: ' + id);
+            return h.apply(null, args);
+        },
+        getCommands() {
+            return Promise.resolve(Object.keys(_handlers));
+        },
+    };
+
+    module.exports = { commands: commands, _handlers: _handlers };
+}

package/server.mjs

@@ -2,12 +2,45 @@
 // It delegates to the extension host's runtime implementation of this module by calling
 // `globalThis.require` (which ensures that the extension host's `require` is called at runtime).
 //
+// When running outside an extension host (e.g., standalone CLI execution), this module provides a
+// lightweight fallback that captures registerCommand handlers so they can be invoked directly.
+//
 // This dummy file is used when extension is bundled with a JavaScript bundler that lacks support for externals
 // (or when `cdeops/server` is not configured as an external module). Parcel does not support externals
 // (https://github.com/parcel-bundler/parcel/issues/144). Webpack, Rollup, and Microbundle support externals.
 
-// ESM named exports must be statically analyzable, so we can only reliably export the module as default.
-// Consumers should use: import cdeopsServer from 'cdeops/server'; then access cdeopsServer.commands, etc.
-// Or use: import cdeopsServer from 'cdeops/server'; const { commands, configuration } = cdeopsServer;
-const cdeopsServer = globalThis.require('cdeops/server');
+// Try the extension host first; fall back to a standalone shim for CLI use.
+let cdeopsServer;
+try {
+  const candidate = globalThis.require('cdeops/server');
+  if (candidate && typeof candidate.commands === 'object') {
+    cdeopsServer = candidate;
+  }
+} catch (_) {
+  // No extension host — use standalone fallback below.
+}
+
+if (!cdeopsServer) {
+  // ── Standalone fallback ─────────────────────────────────────────────────────
+  const _handlers = Object.create(null);
+  const commands = {
+    _handlers,
+    registerCommand(id, handler) {
+      _handlers[id] = handler;
+      return { dispose() { delete _handlers[id]; } };
+    },
+    executeCommand(id, ...args) {
+      const h = _handlers[id];
+      if (!h) throw new Error('Command not found: ' + id);
+      return h(...args);
+    },
+    getCommands() {
+      return Promise.resolve(Object.keys(_handlers));
+    },
+  };
+  cdeopsServer = { commands, _handlers };
+}
+
 export default cdeopsServer;
+export const commands = cdeopsServer.commands;
+export const _handlers = cdeopsServer._handlers;