@mcsherrylabs/pi-meerkat 0.7.0 → 0.10.1

package/dist/installer.d.ts

@@ -0,0 +1,401 @@
+export type Mode = 'devnet' | 'local';
+export interface Installation {
+    version: 1;
+    uid: number;
+    id: string;
+    dir: string;
+    project: string;
+    mode: Mode;
+    nodeId: string;
+    committeeId?: string;
+    identity: string;
+    registryOperator: string;
+    channel: string;
+    ports: [number, number, number];
+    packageVersion: string;
+    daemonId: string;
+    initialization: 'pending' | 'attempted' | 'complete';
+    ready?: true;
+    binding?: {
+        chainId: string;
+        nodeId: string;
+    };
+}
+export interface InstallerDeps {
+    command(command: string, args: string[], env?: NodeJS.ProcessEnv, cwd?: string): Promise<string>;
+    committeeReady?(state: Installation, env: NodeJS.ProcessEnv): Promise<void>;
+    nodeBinding(state: Installation, env: NodeJS.ProcessEnv): Promise<{
+        chainId: string;
+        nodeId: string;
+    }>;
+    registryReady(state: Installation, env: NodeJS.ProcessEnv): Promise<void>;
+    bootstrap(state: Installation, env: NodeJS.ProcessEnv): Promise<void>;
+    claimChannel?(state: Installation, env: NodeJS.ProcessEnv): Promise<void>;
+}
+export declare function managedDirectory(env?: NodeJS.ProcessEnv): string;
+/** Per-mode state directory. The 0.8.0 path `<state>/meerkat/` (installation.json) is never used. */
+export declare function modeDirectory(mode: Mode, env?: NodeJS.ProcessEnv): string;
+export declare const managedConfigPath: (mode?: Mode, env?: NodeJS.ProcessEnv) => string;
+export declare function pinnedRegistration(version: string, mode?: Mode): {
+    mcpServers: {
+        meerkat: {
+            command: string;
+            args: string[];
+        };
+    };
+};
+export declare function renderDeployment(state: Installation): {
+    name: string;
+    services: {
+        node: {
+            image: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+            container_name: string;
+            entrypoint: string[];
+            build: {
+                context: string;
+                dockerfile: string;
+                labels: {
+                    "io.meerkat.installation": string;
+                };
+                args: {
+                    EVOLVER_NODE_IMAGE: string;
+                };
+            };
+            environment: {
+                APP_NODE_ID: string;
+                DEVNET_API: string;
+                EVOLVER_UPSTREAM_NODE_ID: string;
+                EVOLVER_DA_PEERS: string;
+                EVOLVER_ALLOWED_OUTBOUND: string;
+                EVOLVER_EXECUTION_ENABLED: string;
+                EVOLVER_NODE_PORT: string;
+                EVOLVER_NODE_CONFIG: string;
+                CLAIM_TIMEOUT?: undefined;
+                CLAIM_WATCH_SECS?: undefined;
+            };
+            group_add: string[];
+            volumes: string[];
+            restart: string;
+        };
+        registry: {
+            image: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+            container_name: string;
+            build: {
+                context: string;
+                dockerfile: string;
+                labels: {
+                    "io.meerkat.installation": string;
+                };
+            };
+            user: string;
+            group_add: string[];
+            environment: {
+                EVOLVER_FAUCET_URL: string;
+                EVOLVER_CHAIN_ID: string;
+                APP_NODE_ID: string;
+                EVOLVER_SUBSCRIPTIONS_FILE: string;
+                REGISTRY_CHANNEL: string;
+                REGISTRY_CHANNEL_OPERATOR: string;
+                REGISTRY_READ_ONLY: string;
+                REGISTRY_CONTENT_URL: string;
+                PROCESSOR_HTTP_PORT: string;
+                PROCESSOR_READ_HOST: string;
+                EVOLVER_PROCESSOR_CONTROL_SOCKET: string;
+                EVOLVER_DEVNET_URL?: string | undefined;
+                EVOLVER_TARGET: string;
+                EVOLVER_NODE: string;
+            };
+            volumes: string[];
+            restart: string;
+        };
+        'subscriptions-init': {
+            image: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+            profiles: string[];
+            user: string;
+            environment: {
+                EVOLVER_INITIAL_CHANNELS: string;
+                EVOLVER_OPERATOR_UID: string;
+                EVOLVER_OPERATOR_GID: string;
+                EVOLVER_FAUCET_URL: string;
+                EVOLVER_CHAIN_ID: string;
+                APP_NODE_ID: string;
+                EVOLVER_SUBSCRIPTIONS_FILE: string;
+                REGISTRY_CHANNEL: string;
+                REGISTRY_CHANNEL_OPERATOR: string;
+                REGISTRY_READ_ONLY: string;
+                REGISTRY_CONTENT_URL: string;
+                PROCESSOR_HTTP_PORT: string;
+                PROCESSOR_READ_HOST: string;
+                EVOLVER_PROCESSOR_CONTROL_SOCKET: string;
+                EVOLVER_DEVNET_URL?: string | undefined;
+                EVOLVER_TARGET: string;
+                EVOLVER_NODE: string;
+            };
+            entrypoint: string[];
+            command: string[];
+            volumes: string[];
+        };
+        committee?: undefined;
+    };
+    volumes: {
+        'node-data': {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        'app-state': {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        subscriptions: {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        'agent-state': {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        'node-control': {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        control: {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        'committee-data'?: undefined;
+        genesis?: undefined;
+    };
+    networks: {
+        default: {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+            internal?: undefined;
+        };
+    };
+} | {
+    name: string;
+    services: {
+        committee: {
+            image: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+            container_name: string;
+            build: {
+                context: string;
+                dockerfile: string;
+                labels: {
+                    "io.meerkat.installation": string;
+                };
+                args: {
+                    EVOLVER_NODE_IMAGE: string;
+                };
+            };
+            entrypoint: string[];
+            environment: {
+                NODE_ID: string | undefined;
+                PUBLIC_HOST: string;
+            };
+            group_add: string[];
+            volumes: string[];
+            restart: string;
+        };
+        node: {
+            image: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+            container_name: string;
+            entrypoint: string[];
+            build: {
+                context: string;
+                dockerfile: string;
+                labels: {
+                    "io.meerkat.installation": string;
+                };
+                args: {
+                    EVOLVER_NODE_IMAGE: string;
+                };
+            };
+            environment: {
+                APP_NODE_ID: string;
+                DEVNET_API: string;
+                EVOLVER_UPSTREAM_NODE_ID: string | undefined;
+                EVOLVER_ALLOWED_OUTBOUND: string;
+                EVOLVER_EXECUTION_ENABLED: string;
+                EVOLVER_NODE_PORT: string;
+                CLAIM_TIMEOUT: string;
+                CLAIM_WATCH_SECS: string;
+                EVOLVER_DA_PEERS?: undefined;
+                EVOLVER_NODE_CONFIG?: undefined;
+            };
+            group_add: string[];
+            volumes: string[];
+            restart: string;
+        };
+        registry: {
+            image: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+            container_name: string;
+            build: {
+                context: string;
+                dockerfile: string;
+                labels: {
+                    "io.meerkat.installation": string;
+                };
+            };
+            user: string;
+            group_add: string[];
+            environment: {
+                EVOLVER_FAUCET_URL: string;
+                EVOLVER_CHAIN_ID: string;
+                APP_NODE_ID: string;
+                EVOLVER_SUBSCRIPTIONS_FILE: string;
+                REGISTRY_CHANNEL: string;
+                REGISTRY_CHANNEL_OPERATOR: string;
+                REGISTRY_READ_ONLY: string;
+                REGISTRY_CONTENT_URL: string;
+                PROCESSOR_HTTP_PORT: string;
+                PROCESSOR_READ_HOST: string;
+                EVOLVER_PROCESSOR_CONTROL_SOCKET: string;
+                EVOLVER_DEVNET_URL?: string | undefined;
+                EVOLVER_TARGET: string;
+                EVOLVER_NODE: string;
+            };
+            volumes: string[];
+            restart: string;
+        };
+        'subscriptions-init': {
+            image: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+            profiles: string[];
+            user: string;
+            environment: {
+                EVOLVER_INITIAL_CHANNELS: string;
+                EVOLVER_OPERATOR_UID: string;
+                EVOLVER_OPERATOR_GID: string;
+                EVOLVER_FAUCET_URL: string;
+                EVOLVER_CHAIN_ID: string;
+                APP_NODE_ID: string;
+                EVOLVER_SUBSCRIPTIONS_FILE: string;
+                REGISTRY_CHANNEL: string;
+                REGISTRY_CHANNEL_OPERATOR: string;
+                REGISTRY_READ_ONLY: string;
+                REGISTRY_CONTENT_URL: string;
+                PROCESSOR_HTTP_PORT: string;
+                PROCESSOR_READ_HOST: string;
+                EVOLVER_PROCESSOR_CONTROL_SOCKET: string;
+                EVOLVER_DEVNET_URL?: string | undefined;
+                EVOLVER_TARGET: string;
+                EVOLVER_NODE: string;
+            };
+            entrypoint: string[];
+            command: string[];
+            volumes: string[];
+        };
+    };
+    volumes: {
+        'committee-data': {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        genesis: {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        'node-data': {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        'app-state': {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        subscriptions: {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        'agent-state': {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        'node-control': {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+        control: {
+            name: string;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+    };
+    networks: {
+        default: {
+            name: string;
+            internal: boolean;
+            labels: {
+                "io.meerkat.installation": string;
+            };
+        };
+    };
+};
+export declare function operatorEnvironment(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function managedInstallation(mode?: Mode, env?: NodeJS.ProcessEnv): Promise<Installation | undefined>;
+/** Protocol-only stdio bridge, one new facade/private child/session per harness connection.
+ * Docker exec works even when daemon and harness share neither filesystem nor loopback. */
+export declare function serveManaged(state: Installation, env?: NodeJS.ProcessEnv): Promise<void>;
+export declare function installMeerkat(mode?: Mode, env?: NodeJS.ProcessEnv, deps?: InstallerDeps): Promise<{
+    dir: string;
+    configPath: string;
+    registration: {
+        mcpServers: {
+            meerkat: {
+                command: string;
+                args: string[];
+            };
+        };
+    };
+}>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/installer.d.ts.map

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